home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tk / getuid.z / getuid
Encoding:
Text File  |  1998-10-30  |  2.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333TTTTkkkk))))                                                  TTTTkkkk____GGGGeeeettttUUUUiiiidddd((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tk_GetUid, Tk_Uid - convert from string to unique identifier
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  13.  
  14.      ####ttttyyyyppppeeeeddddeeeeffff cccchhhhaaaarrrr ****TTTTkkkk____UUUUiiiidddd
  15.  
  16.      Tk_Uid
  17.      TTTTkkkk____GGGGeeeettttUUUUiiiidddd(_s_t_r_i_n_g)
  18.  
  19. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.      char*_s_t_r_i_n_g(in)
  21.      String for which the corresponding unique identifier is desired.
  22.  
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      TTTTkkkk____GGGGeeeettttUUUUiiiidddd returns the unique identifier corresponding to _s_t_r_i_n_g.  Unique
  26.      identifiers are similar to atoms in Lisp, and are used in Tk to speed up
  27.      comparisons and searches.  A unique identifier (type Tk_Uid) is a string
  28.      pointer and may be used anywhere that a variable of type ``char *'' could
  29.      be used.  However, there is guaranteed to be exactly one unique
  30.      identifier for any given string value.  If TTTTkkkk____GGGGeeeettttUUUUiiiidddd is called twice,
  31.      once with string _a and once with string _b, and if _a and _b have the same
  32.      string value (strcmp(a, b) == 0), then TTTTkkkk____GGGGeeeettttUUUUiiiidddd will return exactly the
  33.      same Tk_Uid value for each call (Tk_GetUid(a) == Tk_GetUid(b)).  This
  34.      means that variables of type Tk_Uid may be compared directly (x == y)
  35.      without having to call ssssttttrrrrccccmmmmpppp.  In addition, the return value from
  36.      TTTTkkkk____GGGGeeeettttUUUUiiiidddd will have the same string value as its argument
  37.      (strcmp(Tk_GetUid(a), a) == 0).
  38.  
  39.  
  40. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  41.      atom, unique identifier
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.